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MONIKER METHOD. APPARATUS. SYSTEM 
AND ARTICLE OF MANUFACTURE 

5 BACKGROUND OF THE INVENTION 

Field of the Invention. 

The present invention relates to a method, system, apparatus and an article of 
10 manufacture for accessing objects or more particularly, to a moniker for locating, 
activating and (or) initializing specific instances of program objects particularly in a large 
computer system environment such as a network and (or) particularly in an environment 
where the object is not registered, i.e., does not have a persistent state. 

15 Related Information. 

A moniker is a "smart" name which contains information that is used to link to 
instances of other objects. Monikers are Object Oriented Programming (OOP) 
programs and a better appreciation of them will be realized from the following general 
20 discussion 

Object-Oriented Programming (OOP) is based on the ideology of using 
independent modular programs, called objects, as the building blocks for programming 
applications. The programming applications themselves may be considered composites 
25 of these objects. OOP prefers to think of a programming application as a client that 
invokes a particular object program, known as a class, as an instance of that object. 
The modularity of programming objects allows them to be instantiated, i.e., invoked, a 
plurality of times to create several run-time versions, i.e., objects, of the same object 
program. And therein lies the power of OOP - pieces of software (i.e., the object 
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programs) are used, reused and interchanged between programming applications 
thereby avoiding redundancy, maintaining efficiency and freeing programmers to focus 
their attentions on the kernel, or core, of the programming application. 

Windows NT™ (Windows New Technology) is a common operating system 
(O/S) from Microsoft™ that supports the OOP methodology. To support this 
methodology, Windows NT™ must provide a platform for executing OOP applications 
and accessing objects. In order to interface OOP application programs to the Windows 
NT™ operating platform, the O/S provides a set of functions, also referred to as 
methods, called the Application Programming Interface (API). The API is a language 
message format used by an application program to communicate with the Windows 
NT™ operating system (or other system program such as a database management 
system). APIs are implemented by writing function calls in the program that provide the 
linkage to a specific subroutine for execution. 

Component Object Model (COM) is the component software architecture that 
the Windows NT™ operating system employs to access objects. Accessing objects in a 
common way on a system is paramount when one considers that objects, according to 
OOP methodology, are independent from the client. Thus, objects may be located 
anywhere on the system including program applications or persistent memory. To 
effect a common accessing scheme, COM defines a set structure for building program 
routines (objects) that can be called up and executed in the Windows™ environment. 
COM itself is written in an OOP language and objects therein are known as COM 
objects. 

Programmers have evolved COM into a compound document technology known 
as Object Linking and Embedding (OLE) to handle the complex task accessing or 
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embedding objects in appfications or documents, called the container application. OLE, 
for example, allows an object such as a spreadsheet or video clip to be embedded into 
a document, called the container application. When the object is double clicked, the 
application that created it, called the server application, is launched in order to edit it. 
5 An object can be linked instead of embedded -in which case the container application 
does not physically hold the object, but provides a pointer to it. If a change is made to a 
linked object, all the documents that contain that same link are automatically updated 
the next time the user opens them. An application can be both client and server. 

10 The present invention relates to accessing objects within the COM environment. 

In order to instantiate a COM class, the client must first grab hold of a pointer to a COM- 
compliant interface. The set of operations carried out to somehow retrieve a valid 
interface pointer to a live object is called binding. In the case where the client needs 
only a general instance of the class, this interface pointer is obtained by creating a new 

15 instance of the co-class through the well known CoCreatelnstanceQ API provided by 
OLE, as demonstrated in the following code snippet: 

I Interface* NewObject(clsid) 

{ 

20 HRESULT hr; 

llnterface* plnterface = NULL; 
// Error handling omitted 

hr= CoCreatelnstance(clsid, NULL, CSLCTX_ALL, I IDJ Interface, 
(void**)&plnterface); 

25 

if (SUCCEEDED(hr)) 

return plnterface; 

return NULL; 
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The function CoCreatelnstance creates an instance of the identified class and receives 
a pointer to the IDispatch interface of that instance. The IDispatch interface allows for 
the invocation of methods that are bound to at run time. 

The foregoing interface works well for instantiating objects. However, when the 
client needs to access an already - existing object (a specific instance), the 
CoCreatelnstance function is not applicable. For example, in the case where an 
Excel™ application (client) links to a pre-stored Excel™ data file (specific instance), it 
will not do to instantiate a new object. Instantiating a new object creates a new version 
of that object - it does not access the specific instance. 

Moreover, it is undesirable to employ the CoCreatelnstance function because it 
requires the server to be actively involved in instantiating the relevant object. Recalling 
that the tenet of Object Oriented Programming is to establish independency between 
programs, it is unsatisfactory that the server be burdened with calling and passing 
parameters to the instantiation routine. 

COM provides special programming objects called monikers that allow clients, 
such as an Excel™ application, to link specific instances of an object. In simplistic 
terms, a moniker is a smart name which stores that information which allows the client 
to locate and invoke the instance. In our Excel™ example, a call to the moniker that 
points to the Excel™ data file will automatically produce a pointer to the parent Excel™ 
application. In this case, the operating system will automatically launch the Excel™ 
application and link it to the Excel™ data file. The Excel™ application need not be 
concerned about the details of linking to the object. 

Monikers, while useful, are limited because they operate within the COM 
environment. In particular, COM monikers call only those objects that are registered in 
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the operating system. This is a problem because the objects themselves are 
responsible for registration. In the case where, for example, a peripheral element such 
as a PLC (Programmable Logic Controller) is connected to a personal computer (PC), 
the PLC has no conventional way in which to register itself with the operating system. 
In that case, the standard monikers are unable to provide a pointer to the clients of the 
operating system for linking to the PLC. This is particularly true for a PLC that is 
remotely connected. 

Another problem is that monikers automatically instantiate the object whether or 
not the object is already running. In the PLC ™ example, the moniker would cause the 
PLC to be automatically instantiated. This is very dangerous because it may cause an 
otherwise dormant PLC to come "alive" and activate machinery connected thereto. This 
could have disastrous results in a manufacturing environment. 

There is needed a means by which already-running specific instances, 
particularly of the kind heretofore described, are linked to client applications that reside 
on an operating server particularly where the object has not registered itself with the 
operating system. It is important that any such means operate within the bounds of the 
ideology of maintaining independency between the servers and clients as proscribed by 
Object Oriented Programming. 

OBJECTS AND SUMMARY OF THE INVENTION 

It is an object of the present invention to access programming objects. 

It is another object of the present invention to access specific instances of 
programming objects. 

It is yet another object of the present invention to access unregistered specific 
instances of programming objects. 
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It is still another object of the present invention to access already-running 
programming objects. 

It is quite another object of the present invention to access programming objects 
associated with a PLC. 

It is further another object of the present invention to access programming 
objects remotely. 

It is indeed another object of the present invention to maintain the object oriented 
programming methodology of independency of servers and objects. 

In accordance with the foregoing objectives, the present invention provides 
means, method, apparatus, system and article of manufacture for accessing specific 
instances of already-running programming object(s). In one aspect of the present 
invention, there is provided a manner in which there is accessed a specific instance(s) 
associated with a PLC coupled to an operating system in the case where the specific 
instance is not registered with the operating system such that a server is not able to 
normally access the specific instances using a registration of the operating system. The 
invention, upon the determination that the specific instance is not registered, registers 
the specific instance such that the server is able to randomly access the specific 
instance. 

In another aspect of the present invention, objects are accessed via remote 
access such as the internet, intra-net or other remote access. An additional aspect of 
the invention accesses objects while maintaining the methodology of programming 
independency characteristics of object-oriented programming. 

These and other objects will be appreciated in light of the following description of 
the drawings wherein the numerals correspond to like elements. 

BRIEF DESCRIPTION OF THE DRAWINGS 



Fig. 1 is a flow diagram of the present invention; 

6 

masperas/se&a/applications/7475/7475app 



99P7475US01 



Figs. 2A-2G are software listings of the present invention; 
Fig. 3 illustrates the apparatus of the present invention; and 
Fig. 4 is a flow diagram of the present invention. 

5 DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

The present invention relates to a method, system, apparatus and an article of 
manufacture for accessing computer programs. In a preferred mode, the present 
invention is practiced in the form of a moniker for locating, activating and (or) initializing 

10 program objects particularly in a large system environment and (or) particularly in an 
environment where the object does not necessarily have a persistent state. It will be 
appreciated by those skilled in the art that the invention may be practiced in another 
form. For that matter, this disclosure shall not be construed to limit the present 
invention to any specific environment (i.e., Microsoft™, Windows NT™, COM 

15 environment), but may be applied to any platform, environment or operating system. 
While the present invention has been described based on the C++ programming 
language, the disclosure shall not be understood to limit the invention to any particular 
computer programming language (C++, etc), but may include any language. The 
present invention may, moreover, be practiced not only as a method or process, i.e., 

20 computer program - but as firmware, that is, hardware implementation (Programmable 
Memory, Integrated Circuit), an article of manufacture (CD or DVD disc, etc.) encoded 
with software, or a machine or apparatus (processor controlled computer, etc.) as 
supported by the specific machine implementation set forth in the disclosure. 

25 It is possible, using monikers, to access an already-running (specific instances) 

of an object. Monikers contain information that allows COM objects to be located, 
activated and initialized. Actually, monikers are themselves COM objects. From a more 
technical point of view, a moniker is a composite name for an object that includes a 
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pointer to the object. Clients invoke a moniker by holding references to it in the form of 
pointers to the [moniker interface. 

The IMoniker interface includes a function (BindToObject) for binding the 
moniker to the object to which the pointer of the moniker points. Binding causes an 
object to be placed in a running state so that the services supplied by the object may be 
invoked. This interface contains a large number of other methods to cope with different 
situations, but the key one for this discussion is the method, BindToObject() shown 
here: 

interface IMoniker : IPersistStream 

{ 

HRESULT BindToObject([in] IBindCtx *pbc, 

[in] IMoniker *pmkToLeft, 

[in] REFIID riidResult, 

[out] void **ppvResuit); 
// other methods removed for clarity 

The client invokes the BindToObject() function of IMoniker to execute the binding 
process. The precise implementation details are - as usual for COM - up to the object 
that implements IMoniker. But in principle, if the object happens to be already running, 
BindToObject() should be able to find it and return an interface pointer on it. If the object 
is crystallized in a persisted state on a storage medium, it is BindToObject() which ought 
to be able to locate the right server for the class it belongs to, launch this server and ask 
it to bring it back to life in memory, all without any aid on the client side. The resultant 
interface pointer of type hid (third parameter) is returned in ppvResult (fourth 
parameter), assuming that the process has run smoothly and flawlessly. 
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Besides the Imoniker interface, the COM specification allows monikers to be 
defined by a string of text, i.e., a string moniker, called the display name of the 
moniker. The display name is made up of two distinct parts separated by the : delimiter. 
The substring to the left of the : determines the type of moniker, while the substring to 
5 the right is highly instance-specific and furnishes a textural version of the state of the 
object. 

However, the display name cannot be translated into a fully functional class 
instance in a single pass. The display name must first be parsed. This is done by 

10 calling the MkParseDisplayName() API (declared in objbase.h) that determines the type 
of moniker by converting the moniker prefix substring from a Progld to a CLSID. After 
that, the IParseDisplayName function is called that first queries the class object of the 
moniker and, if the response is negative, querying a new instance of the coclass 
allocated for this purpose. After a valid pointer to IParseDisplayName is obtained, the 

15 function passes the entire display string to I parseDisplayName ::ParseDisplayName(), 
which is supposed to do the hard parsing work and calls the (Moniker function described 
above that returns an appropriate moniker object. 

Monikers save programmers time when coding various types of COM-based 
20 functions. The linked document, for example, contains a moniker that identifies its 
source, so when the user or program activates the linked object to edit it, the moniker is 
bound. Thus, it becomes possible to load the source into memory without any precise 
knowledge of where the linked object resides. This is particularly important as it frees 
clients from being burdened with locating objects. 

25 

The ability to access objects easily makes Monikers useful for instantiating 
classes within the OLE environment (Object Linking and Embedding). Again, OLE 
allows an object to be embedded into a document, called the container application. An 
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object can be linked instead of embedded - in which case the container application does 
not physically hold the object, but provides a pointer to it. In any event, monikers are 
quite useful for instantiating objects within compound documents. 

Platforms provide built-in moniker types that implement the most recurring 
binding algorithms. These are summarized briefly in the table below: 

Name Special RequirementdDescription 
Class Windows NT 4.0+ Binds to a class object 



Moniker 



File 

Moniker 



Binds to an object persisted on file 



Pointer 
Moniker 



Encapsulates a pointer to an active 
object in a moniker 



Composit 
e Moniker 



Combination of several monikers 



Item 
Moniker 



Sub-object in a composite moniker 



Java 
Moniker 



Internet Explorer 
4.0+ 



Exposes the classes exported by the 
IE4 JVM 



URL 
Moniker 



Internet Explorer 
3.0+ 



Encapsulates a URL pointing to a 
distributed resource 



ObjRef Win98, Win95 with 
Moniker DCOM, WinNT 4.0 
SP4+ 



Encapsulates a pointer to an object 
running out-of-process in a moniker 



Anti 

Moniker 



Nullifies other monikers in a composite 
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However, the foregoing monikers require local parameter data to access a 
specific instance. For example, a specific instance of the class balloon is meaningless 
without the local parameter that indicates the specific color of this particular balloon. 
Typically, local parameters are accessed by clients in persistent memory, that is, 
5 memory that continues to exist after the program that created it is not available. 
Problematically, it is not so easy to obtain the persistent data - this is particularly true 
for large network systems where the persistent data may be located anywhere on the 
network. 

10 This problem is compounded when it is considered that it is not always the case 

that objects are responsible for registering themselves on the Running Object Table 
(ROT). When a client desires to instantiate a specific instance, it fetches the pointer of 
the persistent data by first looking up the registered object on the ROT. In the case 
where the running object failed to register itself on the ROT, only that running object has 

15 the pointer to the persistent data and the client cannot instantiate that specific instance. 

These problems may be better understood by analyzing the following file moniker 
construct. This file moniker is a moniker that binds to an object persisted on file. More 
specifically, the file moniker is encapsulated in the API call CoGetObject. Within this 
20 function, the file path is identified in a string (c:\MyDirectory\MyFile.ext). If the file is a 
compound document, that is, a document composed of more than one object, COM 
may use the API function call GetClassFile to retrieve the CLSID (the class ID - a 
unique number that identifies the type of the object) from the persistent data stored in 
the file. 

25 

Once the class is known, COM checks the ROT to determine if an instance with 
this persistent state has been registered as running. If the instance is registered, then 
COM returns the pointer of this object to the client. If the instance is not registered, then 

n 
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an instance of the object is instantiated and COM queries the object for a particular 
standard interface (named IPersistFile). If this is successful, the method Load is called 
with the filename. The object can then load the file and initialize its state. The string 
that is passed to CoGetObject can have other formats as those skilled in the art will 
5 appreciate. 

In the case that the object is stored in a container, the OLE filelitem moniker, i.e., 
c:\MyDirectory\MyFile.extlitem1, is employed. The object named by the file moniker 
with the string "c:\MyDirectory\MyFile .ext" is a container that can hold some objects, 

10 one of which is named "iteml". In this case, after the load function is called on the 
object (or the object has been retrieved from the running object table), the object is 
queried for the interface IParseDisplayName. If this call is successful then an Item 
moniker is returned to the COM and composed with the file moniker. The resulting 
composite moniker, i.e., the combination of the file and the item moniker, is returned to 

15 the client and the method BindToObject of the interface Imoniker is called on it. 

The bind operation occurs in the reverse order. When the composite moniker is 
bound, its splits into two parts - the rightmost constituent moniker (the item moniker) 
and the remaining portion of the composite (in this case the file moniker). BindToObject 

20 is then called on the item moniker. The item moniker cannot resolve its name ("iteml) 
without a container. It calls BindToObject on the moniker to the left asking for the 
interface lOleltemContainer and, if this call is successful, calls the method GetObject 
(passing its name as the parameter). Since the object named by the file moniker is a 
container that understands the string "iteml", the object is retrieved and returned to the 

25 client. A file moniker string can have any number of items allowing the representation of 
arbitrarily complex hierarchies. 

12 
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The analysis of the following string will be illuminative of the operation of the 
afore-described file moniker: 



c:\siemens\MyBigMachine.waflvariabiesimbO 



Identifies item provided by service 
Identifies service 



File moniker for WinAC active file 
In the example string above, the file moniker uses the string 

"c:\siemens\MyBigMachine.waf to locate the server in the ROT. When the object is 
located, it is queried for the interface IParseDisplayName. A file moniker is created for 
this object that will be used in the subsequent compose operations. 



20 The ParseDisplayName method of the interface IParseDisplayName is called with the 
item name "variables" and if the operation is successful an item moniker is created 
which is then composed with the file moniker created above. The resulting object is 
then queried for the interface IParseDisplayName and the method ParseDisplayName is 
called with the item name "MBO". If this is successful, another item moniker is created 

25 for the string "MBO" and composed with the composite created in the previous 
operation. At this time, the string is completely consumed. The resulting composite 
moniker is returned to the client for binding. 

The binding operation begins with the rightmost item moniker. The composite is 
30 traversed until reaching the file moniker, where GetObject is called successively with 
each item name. When the sequence is complete, the object representing MBO is 
returned to the client. This object can either support a default property containing the 

13 
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value and/or implement IDataObject. The client can also request only the service 
"variables" by using the moniker, "c:\siemens\MyBigMachine.waflvariables". 

The Data.Ocx (a component of the SIEMENS product WinAC) would use this 
5 moniker to retrieve an IVar session object. 



"MyBigMachine.waf "variables" MBO 




lOleltemContainer lOleltemContainer 

This naming convention can support any level of granularity. It would be possible, for 
20 example, to name elements in data blocks c:\siemens\MyBigMachine.waflvariables (i.e. 
idb51elt4). 

Since the foregoing naming convention will support an arbitrarily complex 
hierarchy, it could be used to name devices and input/output (I/O) points in the field. As 
25 new services are added to the various WinACTM components, no change would have 
to be made to existing clients to use them. All of the servers will support the same basic 
syntax for the moniker strings. However, since the servers themselves are moniker 
providers, each server can extend the syntax as needed. 

30 A client may want to connect to a specific instance of an object that has no 

persistent state and therefore cannot register a File moniker. The moniker of the 
present invention resolves this problem. In summary, this moniker is a software 
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component that allows a server to register an instance of an object in the ROT with a 
user-defined name. The user-defined name can be thought of as an item moniker. 
After an instance of an object is registered in the ROT, that instance is then accessible 
from any client. If a client wants to access the object, it uses the Running moniker to 
search the ROT for the instance and bind to it. A server, thus, can register any number 
of object instances, each with a different name. When a server's execution is 
terminated, it should unregister any object instance that it registered. 

The steps of the present invention will now be described with reference to Fig. 1. 
The first step (S100) is to register the instance. This accomplished by calling the 
following methods provided in the [Running interface: 

HRESULT RegisterlnstanceName (BSTR bstritemName, IUnknowrt*pUnk,long* 
ICookie); 

HRESULT UnregisterinstanceName (long ICookie). 

As a result of the function call, the server passes both a pointer to the instance 
and the desired name to the RegisterlnstanceName method. If this call is successful, 
then a cookie is returned. The server caches the cookie, which is used when the object 
is destroyed as the parameter to the method UnregisterinstanceName. If a server fails 
(i.e., it crashes) to unregister the object upon its destruction, the ROT purges the 
object's moniker on the first attempt to access it. 

The moniker of the present invention implements the standard interface 
IParseDisplayName (S102). A client can locate a named instance of an object by 
calling either GoGetObject or MkParseDisplayName with the following string 
"@Running:ObjectName". At this point, COM converts the ProgID "Running" to the 
CLSID using the API call CLSIDFromProglD. Next, the API call GoGetClassObject is 
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used to instantiate the parser. The object is then queried for the IParseDisplayName 
interface. The method ParseDisplayName is called on that interface to parse the string 
(S103). If the requested object cannot be located in the ROT, an error is returned to the 
client (S104). At this time, a pointer moniker is created (S105) and returned to the client 
5 (S107). The client then calls BindToObject on the returned moniker. When a client is 
finished using the object it releases it. 

If the object registered in the ROT supports the interfaces IParseDisplayName 
and lOieltemContainer, more complex operations are applied (S106). The moniker of 

10 the present invention is capable of querying the object for IParseDisplayName and 
calling the method ParseDisplayName with the name of an item (S108). If this call is 
successful (S109), the returned object can also be queried for IParseDisplayName. If 
not successful, a failure code is returned (S110). If the object supports this interface, 
the name of the object is used to create an item moniker which is composed (S1 11) with 

is the moniker to the right. 

The above steps can be continued recursively for an arbitrary complex hierarchy. 
Once all of the elements of the input string have been consumed, the resulting 
composite moniker is returned to the client for binding (S112). The bind process 
20 BindToObject is called with the interface lOieltemContainer, recursively calling the 
method GetObject until the composite moniker is consumed and the object is returned 
to the client. 

The standard moniker process uses the Microsoft defined interfaces, 
25 lOieltemContainer and IParseDisplayName, and creates only instances of Item and 
Pointer monikers for use during the binding process. The moniker of the present 
invention is not WinAC specific and has no dependencies on any product. It can be 
used for any object that wants to be registered in the ROT. The ability to use the 
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IParseDisplayName and lOleltemContainer interfaces is modeled after the File moniker 
and will work with any object that supports these interfaces. Their use, however, is 
optional and the moniker of the present invention can be used only to register and 
retrieve objects from the ROT. 

5 

Thus, the present invention provides a way to name objects that would otherwise 
stay unnamed. After that, the object can be called (i.e., located) by name. Figs. 2A-2G 
set forth the C++ software implementation of the present invention, wherein: 

10 Fig. 2A: Running.idl 

Contains the definition of the COM interfaces provided by the Running moniker. 



The interface defined by the Running moniker is: 

IRunning: An interface derived from the standard interface I dispatch 

15 

The object "Running Moniker" provides the following interfaces: 
IRunning the interface defined within the file 

I ParseDisplayName a standard interface defined by Microsoft 
lUknown a standard interface defined by Microsoft 

20 

Fig. 2B: Runninq.rqs 

This file contains the necessary registry entries for the Running Moniker. 



Fig. 2C: Crunning.h 

25 This file contains the declaration of the C++ class, which implements the 

functionality of the Running Moniker. 

Figs. 2D-2G: Crunninq. 
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This file contains the actual implementation of the Running Moniker. 
The methods Register instanceName and Unregister instanceName are used 
to put in or remove the name of a running object into or from the table of 
running objects. 

The method ParseDisplayName searches the name of a registered object 
within this table and returns an object, which points to this object. 

It will be appreciated that the present invention may be practiced in other 
programming languages, or as an apparatus or article of manufacture as shown in Fig. 
3. In more detail, Fig. 3 shows the system 300 of the present invention wherein a 
computer 302 (such as a personal computer (PC) ) includes a processor 304, display 
306 (and display connection 308), non-volative memory 31 OA, B, remote connection(s) 
312, ISA/MP I card(s) 314 and PLC(s) 316 (and connections 318). The moniker of the 
present invention may reside, as an article of manufacture, on the non-volatile memory 
31 OA, B such as the disc(s) 31 OA (floppy, CD, DVD, etc.) or resident memory (hard 
disc, cache memory) 31 0B. The PC 301 is connected to PLC(s) 316, via a remote 
connection 312 (USB, COM, Internet, Intranet, Network, RS-232, etc.). The PLCs 316 
may be daisy-chained together by a bus 318 in a master/slave relationship, for example. 
In another aspect, the PLC(s) may be interfaced with firmware 314 (ISA/MPI cards, etc.) 
that are provided by, for example, WinAC or Simatec whose function is to interface and 
communicate with the remote PLC(s) 316. The PLC(s) may also be provided in the 
form of firmware 314 installed in the slots. 

It is possible that the moniker of the present invention be practiced as a dynamic 
link library (d1 1) that communicates through the communication ports (particularly, the 
USB port). In that case, the present invention may incorporate a well-known device 
driver (which one skilled in the art will appreciate how to implement) to achieve a high 
degree of communication between the processor 304 and the PLC(s) 316. For 
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example, the connection may be the USB port and the driver may be an ActiveX™ 
device driver that drives the processor. One of the advantages of this arrangement is 
that the processor is driven directly, i.e., without the need for firmware. 

In operation, the system in one aspect of Fig. 3 loads the moniker of the present 
invention from the non-volatile memory 310A,B. The processor 304, in order to access 
a PLC object, invokes the moniker of the present invention. The moniker retrieves the 
name of the desired PLC, either directly through the remote connection 312 or as 
provided by the interface of the firmware 314 that communicates with the PLC(s) 316. 
For example, an Excel™ client application instantiates the specific instance of the 
master PLC 316 using the moniker of the present invention. At this time, the Excel™ 
client has the pointer to the master PLC and may pass parameters therefrom/thereto. 
For example, the Excel™ client may retrieve operating data from the PLC(s) 316 and 
display the same in Excel™ format on the display 306. This last example is particularly 
useful where the PLC(s) do not otherwise have a convenient means of displaying data. 
It will be appreciated that, since the moniker of this present invention activates already- 
running objects, there is a security measure that an otherwise dormant PLC will not be 
erroneously activated which could disastrously effect connected machinery (i.e., 
motors), not shown. 

The present invention is useful for instantiating specific instances of a soft PLC 
application such as provided by Simatic or WinAC (Siemens proprietary 
hardware/software). In such applications, the PLC may be unable to register itself in the 
operating system. The PLC(s) may not be able to register itself because it is remotely 
connected, for example, through a remote connection such as MPI, Universal Serial 
Bus, COM port, serial port (RS-232) or the like. The PLC may also be installed as 
firmware on a card such as MPI or ISA which has no traditional means to register 
objects. This is significant in a system connected to a plurality of PLCs, because it is 
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necessary for the server to determine the specific PLC to access. Accessing the wrong 
PLC in a real-world environment could be disastrous 

In one particular soft PLC environment, the WinAC environment (proprietary 
5 software/hardware provided by Siemens), the moniker of the present invention is 
utilized to access specific PLC objects. In particular, it is a problem in WinAC to name 
service providers. At the core of the problem, WinAC uses the moniker "@WinAC". 
Problematically, the WinAC moniker names an implementation of the interface IVar 
rather than an instance. The moniker "@WinAC: default", while a more generic 
10 approach, assumes that only one IVar provider is located on a machine. While at the 
present time only one IVar provider can run on a machine (either WinAC or the 
SlotPLC), it is undesirable to limit the system to only one provider. 

In addition, the names of the implementations are part of the moniker. With the 
15 previous strategy, there is no way for the user to apply meaningful names (i.e. 
MyBigMachine) to objects in the system. If the user decides that a different 
implementation is required (for example, switch between WinAC and SlotPLC), the user 
must change the name of the server in the tagfile. This means that the user has to have 
the STEP7 (proprietary Siemens software/hardware) projects and be able to recreate 
20 the tagfile. The tagfile is a database within WinAC which stores the relationship 
between symbolic names (meaningful to the user) and absolute addresses within the 
process. 

There is also a problem with object identity. When a client asks for "@WinAC", 
25 an IVar "session" object is returned. Problematically, each client has its own instance of 
IVar session object. This causes confusion because the use of the moniker implies that 
a client is connecting to a specific instance. The "session" objects are required to 
maintain state information such as server handles. Since the "session" objects maintain 
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a state, they are not interfaces and some other means (namely, the present invention) 
should be provided to create them. 

The moniker of the present invention resolves the foregoing problem of naming 
WinAC service providers by establishing a means by which the user names instances of 
objects. Using the named instance method disclosed herein, it would be possible to use 
the tagfile entry "MyBigMachine, MBO" to refer to MBO of whatever IVar server is 
named "MyBigMachine". This allows the user to change implementations without 
needing to change the tagfile. Indeed, any number of uniquely named instances can 
run simultaneously on one machine. Thus, clients can use the moniker of the present 
invention to connect to the correct instance. 

The following example of the string "Running:MyBigMachinelvariableslmbO", as 
described with reference to Fig. 4, illustrates the manner in which the moniker of the 
present invention can be utilized in the WinAC situation. 

Running:MyBigMachinelvariableslmbO 

Identifies item provided by service 

Identifies service 

Identifies named instance 

Loads running moniker 

The moniker of the present invention uses the string "MyBigMachine" to locate 
the server in the ROT (Step S400). When the object is located (Step S401), it is 
queried for the interface IParseDisplayName (Step S402). A pointer moniker is then 
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created for this object that will be used in the subsequent compose operations (Step 
S404). The ParseDisplayName method of lOleltemContainer is called with the item 
name "variables" (Step S406). If the operation is successful (Step S407), an item 
moniker is created which is then composed with the pointer moniker created above 
(Step S408). The resulting object is queried for IParseDisplayName and the method 
ParseDisplayName is called with the string "ImbO" (Step S410). With the exception of 
using a pointer moniker for the leftmost moniker in the bind operation (Step S412), the 
sequence of operations of the File moniker already described may be implemented 
hereafter. 

The resulting moniker string definition of the WinAC implementation is shown 

below. 

"Running:MyBigMachinelvariableslmbO" 

Item moniker "MBO" 
Item moniker "variables" 
Pointer moniker created with instance found in ROT 
Running moniker searches ROT for "MyBigMachine" 

As will be understood from the foregoing string, the moniker of the present invention 
provides a pointer moniker for each partition of the string. In the situation where the 
object is a soft PLC object, the name of the object comes from an address specially 
allocated by the soft PLC. In WinAC, for example, the name comes from the MPI 
address which is allocated by the processor. The name may also come from the DMA 
channel, memory address, IRQ, or COM port. 
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It will be appreciated that the moniker in one aspect of the present invention 
connects to already running objects. Thus, a security measure, this ensures that an 
otherwise dormant PLC is not activated erroneously. The present invention provides a 
5 flexible and robust method for naming objects with monikers. The correct usage of 
these objects provided by the present invention allows for an extensible solution to 
activation problems. If a standard implementation is applied across all WinAC 
components, it will be easy to put the information needed to connect to a server in a 
database such as the tagfile. By making the servers into moniker providers, the 
10 problem of coordinating updates for parsers as components are changed (created by 
making the moniker parsers intelligent) will be avoided. In the model described, the 
moniker of the present invention does not require any knowledge of the various WinAC 
components. In any case, by having a consistent approach and eliminating special 
cases, problems are avoided in any environment. 

15 
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What is claimed: 

1. A method for accessing a specific instance associated with to a 
programmable logic controller coupled to an operating system, wherein said specific 
instance is not registered with said operating system such that a server of said 
operating system is not able to normally access said specific instance using a 
registration of said operating system, wherein said specific instance has specific 
parameters that differentiate said specific instance from other instances, the method 
comprising the steps of: 

determining that said specific instance is not registered with the 
operating system; and 

registering said specific instance with said operating system such 
that said specific instance of said object, that was previously not registered with 
said operating system such that said server was not able to normally access said 
specific instance, is accessible by said server by checking said operation 
system's registration. 

2. The method according to claim 1 , wherein said step of registering does 
not register objects that are not running such that a dormant programmable logic 
controller is not erroneously activated. 

3. The method according to claim 1, further comprising the step of remotely 
coupling said programmable logic controller to said processor. 

4. The method according to claim 3, wherein said step of remotely coupling 
couples said programmable logic controller to said processor over the internet. 
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5. The method according to claim 1 , further comprising the step of obtaining 
an object name associated with said specific instance from a memory location allocated 
for said programmable logic controller. 

6. The method according to claim 1 , further comprising the step of parsing a 
display name of said object to generate a parsed display name. 

7. The method according to claim 6, further comprising the step of creating a 
pointer moniker using said parsed display name. 

8. The method of claim 7, further comprising the step of binding said pointer 
moniker to said server. 

9. The method of claim 7, further comprising the step of creating an item 
moniker using a portion of said parsed display name to the right of a part corresponding 
to said pointer moniker. 

1 0. The method of claim 6, further comprising the step of binding said item 
moniker to said server. 

1 1 . The method of claim 6, further comprising the step of recursively creating 
item monikers for items. 

12. The method of claim 6, further comprising binding a leftmost portion 
resulting monikers to said server. 
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1 1 3. A method for accessing a specific instance of an object associated with an 

2 operating system, wherein said specific instance is not registered with said operating 

3 system such that a server of said operating system is not able to normally access said 

4 specific instance using a registration of said operating system, wherein said specific 

5 instance has specific parameters that differentiate said specific instance from other 

6 instances, the method comprising the steps of: 



7 determining that said specific instance is not registered in said running 

8 object table; and 

9 registering said specific instance with said operating system such that said 
10 specific instance of said object, that was previously not registered with said operating 

n system such that said server was not able to normally access said specific instance, is 

12 accessible by said server by checking said operation system's registration. 

1 1 4. The method of claim 1 3, further comprising the step of converting a 

2 program ID to obtain a class ID of said specific instance. 

1 15. The method of claim 14, further comprising the step of a parsing moniker 

2 string to obtain a parsed moniker string. 

1 1 6. The method of claim 1 5, further comprising the step of creating a pointer 

2 moniker to said specific instance using said parsed moniker string. 

1 17. The method of claim 16, further comprising the step of binding said pointer 

2 moniker to said server. 

1 1 8. The method of claim 1 7, further comprising the step of instantiating said 

2 specific instance using said pointer moniker. 
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1 1 9. The method of claim 13, wherein said specific instance is associated with 

2 a programmable logic controller, wherein said step of registering registers said specific 

3 instance without changing a tagfile server name. 

1 20. The method of claim 19, further comprising the step of binding a pointer 

2 moniker of said specific instance to a client. 

l 21. An apparatus for accessing a specific instance associated with a 



2 programmable logic controller coupled to an operating system, wherein said specific 

3 instance is not registered with the operating system such that a server of said operating 

4 system is not able to normally access said specific instance by accessing a registration 

5 of said operating system, wherein said specific instance has specific parameters that 

6 differentiate said specific instance from other instances, the apparatus comprising: 

7 a memory for registering said specific instance with said operating system; 

8 and 

9 a processor for determining that said specific instance is not registered in 

10 said memory and for registering said specific instance with said operating system such 

11 that said specific instance of said object, that was previously not registered with said 

12 operating system such that said server was not able to normally access said specific 
B instance, is accessible by said server by accessing said registration of said operating 
14 system. 



1 22. The apparatus according to claim 21, further comprising a connection for 

2 remotely coupling said operating system to said programmable logic controller. 

1 23. The apparatus according to claim 22, wherein said connection is an 

2 internet connection. 
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1 24. The apparatus according to claim 22, wherein said connection is a 

2 Universal Serial Bus connection. 

1 25. The apparatus of claim 21 , wherein said connection is a communications 

2 (COM) port connection. 

1 26. The apparatus according to claim 21 , wherein said processor is driven by 

2 a dynamic link library that drives said processor according to signals associated with 

3 said programmable logic controller. 

1 27. The apparatus of claim 21 , further comprising a display for displaying 

2 signals associated with said programmable logic controller. 

1 28. The apparatus of claim 27, wherein said processor processes said signals 

2 associated with said programmable logic controller to transform said signals into signals 

3 of a predetermined format defined by said server for display on said display. 

1 29. The apparatus of claim 21, further comprising a personal computer (PC) 

2 that includes said processor and provides said coupling to said programmable logic 

3 controller. 

1 30. The apparatus of claim 29, wherein said PC establishes a remote 

2 connection to couple said processor to said programmable logic controller. 

1 31 . The apparatus of claim 21 , further comprising a plurality of programmable 

2 logic controllers coupled to said processor. 
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1 32. The apparatus according to claim 31 , further comprising a connection 

2 between said plurality of programmable logic controllers thereby forming a master-slave 

3 relationship in which a master programmable logic controller directs control of 

4 machinery coupled to a slave programmable logic controller. 

1 33. The apparatus of claim 21 , further comprising firmware for providing an 

2 interface between said processor and said programmable logic controller. 

1 34. The apparatus of claim 33, wherein said firmware provides identification 

2 information of said programmable logic controller that is used by the processor for 

3 registering said specific instance. 

1 35. The apparatus of claim 33, wherein said firmware is a personal computer 

2 card. 

1 36. An apparatus for accessing a specific instance associated with a 

2 programmable logic controller coupled to an operating system, wherein said specific 

3 instance is not registered with the operating system such that a server of said operating 

4 system is not able to normally access said specific instance by accessing a registration 

5 of said operating system, wherein said specific instance has specific parameters that 

6 differentiate said specific instance from other instances, the apparatus comprising: 

7 memory means for registering said specific instance with said operating 

8 system; and 

9 processor means for determining that said specific instance is not 

10 registered in said memory means and for registering said specific instance with said 

n operating system such that said specific instance of said object, that was previously not 

12 registered with said operating system such that said server was not able to normally 
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13 access said specific instance, is accessible by said server by accessing said registration 

14 of said operating system. 

1 37. The apparatus according to claim 36, further comprising connection 

2 means for remotely coupling said operating system to said programmable logic 

3 controller. 

1 38. The apparatus according to claim 37, wherein said connection means is a 

2 means to connect to the internet. 

1 39. The apparatus according to claim 37, wherein said connection means is a 

2 means to connect to a Universal Serial Bus connection. 

1 40. The apparatus of claim 36, wherein said connection means is a means to 

2 connect to a communications (COM) port. 

1 41 . The apparatus according to claim 36, further comprising a dynamic link 

2 library means that drives said processor means according to signals associated with 

3 said programmable logic controller. 

1 42. The apparatus of claim 36, further comprising display means for displaying 

2 signals associated with said programmable logic controller. 

1 43. The apparatus of claim 42, wherein said processor means processes said 

2 signals associated with said programmable logic controller to transform said signals into 

3 signals of a predetermined format defined by said server for display on said display. 
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1 44. The apparatus of claim 36, further comprising personal computer (PC) 

2 means that includes said processor means and provides said coupling to said 

3 programmable logic controller. 

1 45. The apparatus of claim 44, wherein said PC means establishes a remote 

2 connection to couple said processor means to said programmable logic controller. 

1 46. The apparatus of claim 36, further comprising a plurality of programmable 

2 logic controllers coupled to said processor means. 

1 47. The apparatus according to claim 46, further comprising connection 

2 means to provide a connection between said plurality of programmable logic controllers 

3 thereby forming a master-slave relationship in which a master programmable logic 

4 controller directs control of machinery coupled to a slave programmable logic controller. 

1 48. The apparatus of claim 36, further comprising firmware means for 

2 providing an interface between said processor means and said programmable logic 

3 controller. 

1 49. The apparatus of claim 48, wherein said firmware means provides 

2 identification information of said programmable logic controller that is used by the 

3 processor means for registering said specific instance. 

1 50. The apparatus of claim 47, wherein said firmware means is a personal 

2 computer card. 

1 51 . An article of manufacture encoded with processor instructions for driving a 

2 processor according to a method for accessing a specific instance of an object 
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3 associated with an operating system, wherein said specific instance is not registered 

4 with said operating system such that a server of said operating system is not able to 

5 normally access said specific instance using a registration of said operating system, 

6 wherein said specific instance has specific parameters that differentiate said specific 

7 instance from other instances, the method of said article of manufacture for driving said 

8 processor comprising the steps of: 



9 determining that said specific instance is not registered in said running 

10 object table; and 

n registering said specific instance with said operating system such that said 

12 specific instance of said object, that was previously not registered with said operating 

13 system such that said server was not able to normally access said specific instance, is 

14 accessible by said server by checking said operation system's registration. 

1 52. The article of manufacture of claim 51 , wherein the processor instructions 

2 encoded on said article of manufacture further comprising the step of converting a 

3 program ID to obtain a class ID of said specific instance. 

1 53. The article of manufacture of claim 52, wherein the processor instructions 

2 encoded on said article of manufacture further comprising the step of a parsing moniker 

3 string to obtain a parsed moniker string. 

1 54. The article of manufacture of claim 53, wherein the processor instructions 

2 encoded on said article of manufacture further comprising the step of creating a pointer 

3 moniker to said specific instance using said parsed moniker string. 

1 55. The article of manufacture of claim 54, wherein the processor instructions 

2 encoded on said article of manufacture further comprising the step of binding said 

3 pointer moniker to said server. 
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1 56. The article of manufacture of claim 55, wherein the processor instructions 

2 encoded on said article of manufacture further comprising the step of instantiating said 

3 specific instance using said pointer moniker. 

1 57. The article of manufacture of claim 52, wherein said specific instance is 

2 associated with a programmable logic controller, wherein said step of registering 

3 registers said specific instance without changing a tagfile server name. 

58. The article of manufacture of claim 57, wherein the processor instructions 
encoded on said article of manufacture further comprising the step of binding a pointer 
moniker of said specific instance to a client. 
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ABSTRACT OF THE DISCLOSURE 

5 

A moniker is provided that accesses already-running instances of objects 
that do not have a resistant state. In one aspect, the objects are associated with a 
programmable logic controller (PLC). The PLC may be a soft PLC that interfaces with a 
personal computer. A remote connection is provided for such that the moniker 
10 instantiates objects of PLCs remotely such as over the internet. 
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// Running. idl : IDL source for Running.dll 

// This file will be processed by the MIDL tool to 

// produce the type library (Running . tlb) and marshalling code. 



uuid(E7531917-289D-llD2-869F-080009DC2552) . 
dual, 

helpstring ("IRunning Interface") , 
pointer_default (unique) 

interface IRunning : IDispatch 

[id 

ItemName, lUnknown ' 

ICookie) ■ lid(2), helpstring ( "method UnregisterlnstanceName") J HRESOLT UnregisterlnstanceName (long 

); 

[ 

uuid(E7531908-289D-llD2-869F-080009DC2552>, 
version(l.O) , 

helpstring ("Running 1.0 Type Library") 
library RUNNINGLib 



coclass Running 
( 

[default] interface IRunning; 
interface IParseDisplayName; 
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Running. rgs 

Running. 1 = s 'Running Class' 

CLSID = s ' {E7531918-289D-11D2-869F-080009DC2552} ' 
Running - s 'Running Class' 

CLSID = s ' {E7531918-289D-11D2-869F-080009DC2552} ' 
NoRemove CLSID 

ForceRemove {E7531918-289D-11D2-869F-080009DC2552} = s "Running <S1 

val AppID = s ' {E7531918-289D-11D2-869F-080009DC2552} * 
ProgID *= s 'Running. 1' 

VersionlndependentProgID = s 'Running' 
ForceRemove ' Programmable ' 
InprocServer32 = s '%MODULE%' 
I 

val ThreadingModel = s 'Apartment' 

} 

} 

} 

NoRemove AppID 
{ 

NoRemove {E7531918-289D-11D2-869F-080009DC2552 } = s 'Running Class 
val DllSurrogate = s ' ' 

} 

} 
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CRunning.h 

// CRunning.h : Declaration of the CRunning 

#ifndef RUNN I NG_H 

*def ine, RUNNING_h3 

Hnclude "resource. h" // main symbols 

///////////////////////////////////////////////////////////////////////////// 
// CRunning 

class ATL_NO_VTABLE CRunning : 

public CComObjectRootEx<CComSingleThreadModel>, 
public CComCoClass<CRunning, SCLSID Running>, 

public IDispatchlmpKIRunning, siID~IRunning, &LIBID_RUNNINGLib>, 
public IParseDisplayName 

CRunning { ) 
{ 

ATLTRACE (_T { "CRunning ( ) constructor called\n" ) ) ; 



virtual -CRunning <) 
{ 

ATLTRACE (_T C "CRunning ( ) destructor called\n") ) ; 



DECLARE_REGISTRY_RESOURCEID ( I DR_R(JNNI NG ) 

BEGIN_COM_MAP (CRunning) 

~ COM_INTERFACE_ENTRY { IRunning) 
COM_INTERFACE_ENTRY (IDispatch) 
COM_INTERFACE_ENTRY (IParseDisplayName) 
EN D_COM_MAP ( ) 

///////////////////////////////////////////////////////////////// 
// IParseDisplayName method 

STDMETHODIMP ParseDisplayName (IBindCtx *pbc 

, LPOLESTR pszDisplayName 
,ULONG *pchEaten 
, IMoniker * *ppmkOut 
); 

protected: 

const wchar_t* ProglDO ( return L"Running"; } 
const wchar_t* VersionlndependentProgID ( ) ( return L"Running. 1"; ) 

// IRunning 
public: 

STDMETHOD(UnregisterlnstanceName) (long ICookie) ; 

STDMETHOD ( Register InstanceName ) (BSTR bstrltemName, IUnknown * pUnk, long * ICookie) 



#endif // RUNNING_H_ 
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CRunning.cpp 

// CRunning.cpp : Implementation of CRunning 
((include "stdafx.h* 
((include "Running. h" 
#include "CRunning. h" 

Kdefine BAD_POINTER_RETURN (p) if{ !p ) return E POINTER 

#define BAD_POINTER RETURN_OR_ZERO (p) iff !p ) return E_POINTER; else *p - 0 
#define SIZE_OF_STRING (p) !p ? 0 : ((wcslen(p) * sizeof (wchar_t) ) + sizeof (wchar_t ) ) 

#define OLE_MAXNAMESIZE 256 



STDMETHODIMP CRunning: : RegisterlnstanceName. (BSTR bstrltemName, IUnknown * pUnk, long * ICookie) 

AFX_MANAGE_STATE (Af xGetStaticModuleState ( ) ) 

// TODO: Add your implementation code here 

ATLTRACE (_T( "CRunning :: RegisterlnstanceName called\n") ) ; 

H RESULT hr - E_FAIL; 

LPRUNNINGOBJECTTABLE prot - NULL; 

hr - GetRunningObjectTabletO, Sprot) ; 

if (SUCCEEDED (hr) ) 

{ 

LPMONIKER ppmk = NULL; 

hr - CreateltemMoniker (NULL, bstrltemName, ippmk) ; 

if {SUCCEEDED (hr) ) 
( 

hr = prot->Register (0 

,pUnk 
,pprak 

, (unsigned long *) ICookie 
); 

if ( SUCCEEDED (hr) ) 
{ 

TRACE (_T( "CRunning :: RegisterlnstanceName register succeeded cookie is %x\ 

n") , (unsigned long*) *lCookie) ; 

> 

else 
{ 

^ TRACE (_T( "CRunning :: RegisterlnstanceName register failed %x \n"),hr); 

ppmk->Release<) ; 

else 

^ TRACE (_T( "CRunning :: RegisterlnstanceName CreateltemMoniker failed %x \n"),hr); 

prot->Release ( ) ; 

ii* 

^ TRACE (_T ( "CRunning : : RegisterlnstanceName get ROT failed %x \n"),hr); 

return hr; 

}.' 

STDMETHODIMP CRunning :: UnregisterlnstanceName < long ICookie) 
AFX_MANAGE_STATE(AfxGetStaticModuleState(M 
ion code here 
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ifUCookie) 
( 

LPRUNN I NGOB JECTTABLE prot - NULL; 

hr - GetRunningObjectTable(0, iprot) ; 

if ( SUCCEEDED (hr) ) 
f 

hr - prot->Revoke ( (unsigned long) ICookie) ; 

if (SUCCEEDED (hr)) 

< 

TRACE (_T ( "CRunning : :UnregisterInstanceName worked for cookie %x \n"|, (uns 

igned long) ICookie) ; 

) 

else % 
( 

ATLTRACE t_T ( "CRunning : : UnregisterlnstanceName Revoke failed\n") ) ; 

} 

prot->Release() ; 

) 

else 
< 

ATLTRACE (_T ("CRunning: : UnregisterlnstanceName GetROT failed\n")); 



STDMETHODIMP CRunning: : ParseDisplayName ( 
IBindCtx* pbc, 
LPOLESTR pwszDisplayName, 
ULONG* pchEaten, 
IMoniker** ppmkOut) 



{ 



AFX_MANAGE_STATE (Af xGetStaticModuleState ( ) ) 

ATLTRACE (_T ( "CRunning : : ParseDisplayName ( ) with %S\n n ) , pwszDisplayName) ; 

BAD P0INTER_RETURN_OR_ZERO(ppmk0ut) ; 
B AD_POI NTER RETURN_OR_ZER0 (pchEaten) ; 
BAD POINTER~RETURN(pbc) ; 
BAD~POINTER RETURN (pwszDisplayName) ; 
BAD_POINTER~RETURN (pchEaten) ; 

ATLTRACE (_T< "CRunning :: ParseDisplayName 0 pointers OK!\n")); 

HRESULT hr - E_FAIL; 

// set to max for now 

// need to change to fit MkParseEx 

if (*pwszDisplayName -« L'8*) 

* pchEaten - wcslen (L"8Running") ; 

else 

* pchEaten - wcslen (L"Running" ) ; 

//as far as i have been able to find oud 

// MkParse will pass the 8, WRONG! ! 

/ / k oh no!!! MkParseEx doesn't pass the @U 

// we've got to fix this, so let's look for ":" 

wchar_t * pwszlnstance =» wcschr (pwszDisplayName, L' :') ; 

// do we have an instance ? 

if (pwszlnstance) 
f 

ATLTRACE (_T ("CRunning: : ParseDisplayName () instance name %S\n") , pwszlnst; 

WCHAR szltemName [OLE_MAXNAMESIZE] ; 

LPWSTR IpszDest *= szltemName; 

LPWSTR IpszSrc =- pwszlnstance; 

int cEaten = 0; 
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// eat delimiter characters until next token 
while ClpszSrc !- L'\0' 44 ClpszSrc — L'W 
*lpszSrc "~ L ' : ' M -lpgzSrc — L' ! ' I 



// parse next token in szltemName 

while (*lps2Src !- L'\0' && *lpszSrc !- L'W 

*lpszSrc != L' : ' 44 *lpszSrc ! 

cEaten < OLE_MAXNAME S I Z E - 1 ) 



// find the running object 
LPRONNINGOBJECTTABLE prot - NOLL; 
LPENUMMONIKER penuni - NOLL; 

LPMONIKER ppmk - NOLL; 

hr - CreateltemMoniker (NOLL, szltemName, Sppmk) ; 

ATLTRACE (_T ( "CRunning: : ParseDisplayName ( ) CreateltemMoniker %x\n") ,hr) ; 

if (SOCCEEDED (hr) ) 
( 

// look in the running object table to find the gizmo 

// since we are a moniker provider we can't use 
// the bind context to get the ROT 
hr = GetRunningObjectTable (0, sprot); 

ATLTRACE (_T( "CRunning: : ParseDisplayName ( ) GetRunningObjectTable %x\n") ,hr) ; 
if (SOCCEEDED (hr) ) 



{ 



hr « prot->EnumRunning(&penuro) ; 

ATLTRACE (_T( "CRunning: : ParseDisplayName () EnumRunning %x\n"),hr); 
if (SOCCEEDED (hr) ) 



IMoniker 
IMoniker 
I On known 
BOOL 



pprakTest 
ppmkResult 
pOnk 
bFound 



= NOLL; 
= NOLL; 
= NOLL; 
- FALSE; 



while ( (penuiu->Next (1, ippmkTest, NOLL) — S_OK) 44 (! bFound) ) 



ame() created ] 

- NULL; 
pltemMoniker ■■ 



TRACE (_T ( "CRunning : : ParseDisplayName ( ) we found i 
bFound = TROE; 

hr » prot->GetObject (ppmkTest, SpOnk) ; 
if(hr — S_OK) // not SOCCEEDED!! 

{ 

TRACE (_T { "CRunning : : ParseDisplayName ( ) we 

hr = CreatePointerMoniker (pOnk, ippmkResul 

if (SUCCEEDED (hr) ) 
< 

TRACE (_T ( "CRunning: : ParseDisplayN 



.splayName 



' pPai 
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to with it 



// we'll give him the part that i 
// and he can do whatever he want 
♦ppmkOut - ppmkResult; 



' (lID_IParseDisplayName, (void **)spParse); 
eDisplayName (pbc, IpszSrc, SucEaten, SpItemMoniker) ; 

Result->ComposeWith (pltenMoniker, FALSE, ppmkOut) ; 
DED(hr) ) 

RACE (_T ( "CRunning : : ParseDisplayName { ) It worked! !! \n") ) ; 
/ we can release the constituant elements 
/ of the composite 
pmkB.esult->Release { ) ; 

succeed or fail we can release the 
oniker 

ker->Release() ; 



hr - pUnk->QueryInterface 

if (SUCCEEDED (hr) > 
{ 

hr -x pParse->Pars 

if (SUCCEEDED (hr) ) 
{ 

•pchEaten 
hr - ppmk 
if (SUCCEE 
{ 



} 

// if we 
// item m 
pltemMoni 



pParse->Release ( ) 



) 



ppmkTest->Release ( ) ; 



if ( IbFound) 
I 

hr - E FAIL; 

} 

penum->Release ( ) ; 

) 

prot->Release { ) ; 

> 

ppmk->Release ( ) ; 
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